Reporting with TransForm
Description
Build reports using Alpha Anywhere's banded Report Writer for your TransForm data.
Discussion
TransForm is a first-class data source for reports in Alpha Anywhere.
The data in a TransForm form can be quite complex. For example, you may have multiple one-to-many relationships in the data (these are nested arrays in the JSON data) and each child may in turn have its own children (i.e. parent-child-grandchild relationships).
Data in this form is not suitable for the report writer, which needs a "flat" table of records. Therefore, when the data are retrieved from a TransForm form, it is "flattened" (search in documentation for json_flatten() for a description of what "flattening" means)
When you create a new report, the menu includes <TransForm> as an option.
If you select the <TransForm> option, a dialog where you can configure the data source is shown:
Properties of note in the dialog include:
- Property
- Description
- API key
You must specify an API key that has sufficient permissions to retrieve data from your TransForm account.
- FormID
The form id of the form you wish to retrieve data from.
- All fields?
You can specify a subset of the fields in the form to retrieve.
- Arguments
You can specify arguments that can be used in the filters that are applied to the data that are retrieved. The benefit of using arguments is that you can set the value of the arguments at run-time.
You can filter on meta data fields. The meta data fields are different than the actual form data. The meta data fields include the id of the person who submitted the form, the form status, the timestamp (time on the server when the form was submitted) and the Forminstanceid (the primary key for the form instance)
You can filter on the following meta data fields:
- Metadata Field
- Description
- Person
The userid of the person who submitted the form.
- Status
The form status.
- Timestamp
The server time when the form was submitted (different from the time on the user's device).
- FormInstanceId
The primary key of the form instance.
For the Person, Status and FormInstanceId properties, you can enter a comma delimited list of values, or you can use arguments. For example, you might set the Person filter to: :name_of_person
You can also filter and sort on the actual data in the form.
- Expression
- Description
- Filter
A filter expression using simple SQL syntax that allows you to retrieve forms with data in the form fields. All form data when the query is performed is character data.
- Order
An order expression using SQL syntax that allows you to order the data based on data in form fields.
Field Data Type Overrides
By default, all data that is retrieved from TransForm is character data. You might want to explicitly change certain fields to be other types so that the report writer can do calculations and summaries with the data. For example, the form might have a field called Quantity which you would like to convert to a numeric field. The Overrides property allows you to set data type overrides.
Photo fields are an exception. Alpha Anywhere automatically sets photo fields to Image File Reference fields (so that the report writer will recognize these fields as images). You do not need to define overrides for photo fields.
You will need to define overrides for signature fields (use the Ink data type).
See Also